home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
-
- DCWHERE
-
- DCWHERE displays information about all occurances of a filename
- regardless of which directory the filename is located. Its main
- use is to find that file that you are sure you created but is not
- where it is supposed to be. The proper syntax for using DCWHERE
- is DCWHERE filename. Filename is any valid DOS filename
- including the ? and * wildcards. A filename is composed of 1 to 8
- characters which can be followed by a period and a three
- character extension. If you have a color display the information
- will be displayed as yellow characters on a blue background.
- This color combination cannot be changed. The filename can be
- entered in upper or lower case letters. All filenames are
- compared as upper case. The ? character is special in that it
- will match any one character in a filename. The following list
- illustrates how the ? wild card works.
- TEST?.DAT TEST4.dat match
- TEST?.dat TEST.dat match
- TEST?.EXE TEST12.EXE do not match
- TEST.?AT TEST.BAT match
- TEST.?AT TEST.DAT match
- The * character is also a wildcard character. It matches all
- remaining characters in a filename or extension. The following
- list illustrates the use of the * wildcard
- *.* TEST.EXE match
- *.* FROG.DAT match
- *.dat MAIN.DAT match
- *.DAT MAIN.BAT do not match
- TEST* TEST23 match
- TEST.* TEST.BAT match
- TEST.* TEST.EXE match
- DCWHERE *.* matches all files. DCWHERE *.bat matches all files
- with an extension of BAT. DCWHERE TEST.* matches all files whose
- filename is TEST regardless of the extension. DCWHERE
- TEST????.dat will list all files whose extension is DAT and whose
- first four characters are TEST. The remaining four possible
- characters can either be absent or any character and still match.
-
- The screen is laid out in four columns as is shown below
-
- LOCATION DATE LAST MODIFIED SIZE ATTRIBUTE
- C:\IBMBIOS.COM 8/22/85 341256 RSHA
- C:\IBMDOS.COM 8/22/85 221945 RSHA
- C:\TEST.COM 7/12/86 451 A
- C:\DBASE\DBASE.COM 4/22/85 12334 A
-
- Column one is the location and name of the file that matches the
- filename specified. Its format is
- DRIVE:\DIRECTORY1\DIRECTORY2\FILENAME. Column two is the date
- the file was last modified. Column three is the size in bytes of
- the file. The date and size information is the same as the DIR
- command will give. Column four is the attribute bytes of the
-
- 1
-
-
-
-
-
-
- file. H means that the file is HIDDEN. It will not show up
- using a DIR command. S means SYSTEM. Files with the SYSTEM
- attribute set will not show up with a DIR command. R means READ
- ONLY. This file cannot be modified or deleted. The ATTRIBUTE
- command can be used to change this attribute. A means ARCHIVE.
- This means that the file has been modified since the last BACKUP
- command was used. It has no real signifigance outside of being
- used in the BACKUP command. A file can and often does have more
- that one attribute set. Line 23 of the screen shows the
- directories as they are being searched. Line 24 will show
- continuation and error messages. If there are 19 or more matches
- the program will pause and ask if you want to continue searching.
- Pressing any key but N or n will continue searching.
-
- ERROR MESSAGES
-
- Backslash in file name ---- The program will check in all
- directories. Since the backslash marks a directory it should not
- be included in a filename. Reenter the filename without the
- directory information and backslash. DCWHERE \DOS\*.COM (wrong)
- DCWHERE *.COM (correct)
-
- Drive identifier in file name ---- The program will always search
- the current drive only. Therefor the drive identifier should not
- be entered. DCWHERE c:*.bat (wrong) DCWHERE *.bat (correct)
-
- File name too long ---- DOS limits file names to eight characters
- optionaly followed by a period and a three character extension.
- Reenter a valid file name. DCWHERE test1234b (wrong) DCWHERE
- test1234.b (correct)
-
- File extension too long ---- DOS limits the number of characters
- following the period in a file name to three. Reenter with a
- valid extension. DCWHERE *.test (wrong) DCWHERE *.tst (correct)
-
- Only two '*' characters allowed ---- DOS handles only one '*'
- wildcard before the period and one after the period. Reenter
- using only one '*' on either side of the period. DCWHERE *sd*.*
- (wrong) DCWHERE ?sd*.* (correct).
-
- Only one '*' character allowed after period ---- DOS handles only
- one '*' wildcard character after the period. The second one is
- ignored. Reenter using only one '*' after the period.
- DCWHERE dbase.** (wrong) DCWHERE dbase.* (correct)
-
- Both '*' characters appear before the period ---- There can be
- only one '*' wildcard character before the period. Reenter with
- only one '*' before the period. DCWHERE *123*.wks (wrong)
- DCWHERE ?123*.wks (correct)
-
- Return code not found ---- Internal programming problem. Please
- send the example to me at the address in the first part of this
-
- 2
-
-
-
-
-
-
- documentation.
-
- No files found on disk ---- This is a newly formated disk with no
- files on it to search through. Use the command on a disk with
- files already in place.
-
- Only 60 directories can be searched ---- There is an internal
- limit of 60 directories that can be searched by this program.
-
- No file specified to look for ---- You did not include the
- filename to be searched for. Reenter with a file name.
- DCWHERE (wrong) DCWHERE *.bat (correct)
-
- No files are present that match (filename) ---- The program
- could not find any files that match the filename specified. It
- is not on the hard disk.
-
- All directories searched ---- The program has filished looking
- through all the directories on the hard disk.
-
- GLOSSARY
-
- Attribute -- Dos has four indicators that it saves for each file
- called Attributes. They tell wheather the file is a System file,
- Hidden file, or Read Only file. The fourth indicator tells
- wheather the file has been changed since it was last backed up.
-
- Backup -- The DOS command used to copy files to the floppy
- diskettes for backup purposes. This program turns off the
- Archive indicator for the files copied. Files copied using
- Backup can only be restored using the Restore command.
-
- Directory -- A collection of related files that usualy are
- involved with one type of work. A directory can be thought of as
- a file drawer in a filing cabinet. The cabinet is the hard disk.
- Each area has its own drawer to keep its information seperate
- from the other areas. This makes it easier to search through.
- Using the Tree command will display the directory structure.
-
- DOS -- Disk Operating System. This is a program that is the
- gateway into the computer. It loads and executes porgrams plus
- gives you a collection of utilities to manage your computer. You
- can tell its there when you see the C:> prompt.
-
- Extension -- A filename can have one to eight characters as a
- filename and optionaly have a period and one to three characters
- as an extension. Generaly extensions tell what type of file you
- are dealing with.
-
- Filename -- A filename can have one to eight characters as a name
- and optionaly have a period and one to three characters as an
- extension. They are how we distinguish files from each other.
-
- 3
-
-
-
-
-
-
-
- Hidden -- The attribute that controls wheather a file will
- display when the Dir is used. Also a file with the hidden
- attribute set cannot be deleted or copied using Dos commands.
-
- Read Only -- The attribute that controls the access to a file.
- If a file is Read Only it cannot be deleted or copied using Dos
- commands. It can be viewed and executed.
-
- System -- The attribute that specifies files that are part of
- DOS. Has also been used in some copy protection schemes. System
- files cannot be deleted or copied using Dos commands other than
- Sys to transfer the system to a disk(ette) and Formatting with
- the \s option to transfer the system.
-
- Wildcard -- Either the '?' or '*' character in a filename. The
- '?' wildcard will match any one character in a filename to be
- matched with. It will also match the absence of a character in a
- filename. The '*' wildcard matched all remaining characters in a
- filename or extension in the same manner that the '?' matches a
- single character. Both types of wildcards can be used together
- in the same filename.
-
-
-
-
- ----------------end-of-author's-documentation---------------
-
- Software Library Information:
-
- This disk copy provided as a service of
-
- The Public (Software) Library
-
- Disks in the library are updated monthly.
- For a copy of the latest monthly software library newsletter
- and a list of the 800+ disks in the library, call or write
-
- The Public (Software) Library
- P.O.Box 35705 D
- Houston, TX 77235-5705
- (713) 721-6104
-
- We are not the authors of this program, nor are we associated
- with the author in any way other than as a distributor of the
- program in accordance with the author's terms of distribution.
-
- Please direct shareware payments and specific questions about
- this program to the author of the program, whose name appears
- elsewhere in this documentation. If you have trouble getting
- in touch with the author, we will do whatever we can to help
- you with your questions. All programs have been tested and do
- run. To report problems, please use the form that is in the
- file PROBLEM.DOC on many of our disks.
-